home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / assign.z / assign
Text File  |  1998-10-30  |  52KB  |  990 lines
  1. ASSIGN(1)                                              Last changed: 3-9-98
  2.  
  3.  
  4. NNAAMMEE
  5.      aassssiiggnn - Assigns options for library file open processing
  6.  
  7. SSYYNNOOPPSSIISS
  8.      UNICOS and UNICOS/mk systems:
  9.  
  10.         aassssiiggnn [--II] [--OO] [--aa _a_c_t_u_a_l_f_i_l_e] [--bb _b_s] [--cc] [--dd _b_d_r] [--ff _f_o_r_t_s_t_d]
  11.         [--ll _b_u_f_l_e_v] [--mm _s_e_t_t_i_n_g] [--nn _s_z [:_s_t]] [--pp _p_a_r_t_l_i_s_t] [--qq _o_c_b_l_k_s]
  12.         [--rr _s_e_t_t_i_n_g] [--ss _f_t] [--tt] [--uu _b_u_f_c_n_t] [--ww _s_e_t_t_i_n_g] [--xx _s_e_t_t_i_n_g]
  13.         [--yy _s_e_t_t_i_n_g] [--CC _c_h_a_r_c_o_n] [--DD _f_i_l_d_e_s] [--FF _s_p_e_c[,,_s_p_e_c_s]]
  14.         [--LL _s_e_t_t_i_n_g] [--NN _n_u_m_c_o_n] [--PP _s_c_o_p_e] [--SS _s_e_t_t_i_n_g] [--TT _s_e_t_t_i_n_g]
  15.         [--UU _s_e_t_t_i_n_g] [--WW _s_e_t_t_i_n_g] [--YY _s_e_t_t_i_n_g] _a_s_s_i_g_n__o_b_j_e_c_t
  16.  
  17.      IRIX systems:
  18.  
  19.         aassssiiggnn [--II] [--OO] [--aa _a_c_t_u_a_l_f_i_l_e] [--bb _b_s] [--ff _f_o_r_t_s_t_d] [--ss _f_t] [--tt]
  20.         [--yy _s_e_t_t_i_n_g] [--BB _s_e_t_t_i_n_g] [--CC _c_h_a_r_c_o_n] [--DD _f_i_l_d_e_s]
  21.         [--FF _s_p_e_c[,,_s_p_e_c_s]] [--NN _n_u_m_c_o_n] [--SS _s_e_t_t_i_n_g] [--TT _s_e_t_t_i_n_g]
  22.         [--UU _s_e_t_t_i_n_g] [--WW _s_e_t_t_i_n_g] [--YY _s_e_t_t_i_n_g] _a_s_s_i_g_n__o_b_j_e_c_t
  23.  
  24.      All platforms:
  25.  
  26.         aassssiiggnn --RR [_a_s_s_i_g_n__o_b_j_e_c_t]
  27.  
  28.         aassssiiggnn --VV [_a_s_s_i_g_n__o_b_j_e_c_t]
  29.  
  30. IIMMPPLLEEMMEENNTTAATTIIOONN
  31.      UNICOS, UNICOS/mk, and IRIX systems
  32.  
  33. DDEESSCCRRIIPPTTIIOONN
  34.      On IRIX systems, the aassssiiggnn command affects I/O statements in program
  35.      units compiled with the MIPSpro 7 Fortran 90 compiler or compiled with
  36.      the --ccrraayylliibbss option to the MIPSpro 7.2 F77 compiler.
  37.  
  38.      The aassssiiggnn command associates options with Fortran unit numbers and
  39.      file names for use during the library open processing.
  40.  
  41.      The ffffaassssiiggnn(3C) command provides an interface to assign processing
  42.      from C.  See the ffffaassssiiggnn(3C) man page for more details.
  43.  
  44.      Selected options on the aassssiiggnn command are available on IRIX systems.
  45.      The descriptions of each option include the hardware platform where
  46.      the option is available.
  47.  
  48.      The _a_s_s_i_g_n__o_b_j_e_c_t argument can take one of the following formats:
  49.  
  50.      -------------------------------------------------------------
  51.      Format        Example  Attribute association
  52.      -------------------------------------------------------------
  53.      gg::_i_o__t_y_p_e     gg::ssuu     Sequential unformatted open request
  54.      uu::_u_n_i_t__n_u_m_b_e_r uu::99      Fortran unit 9
  55.      pp::_p_a_t_t_e_r_n     pp::ffiillee%%  File names matching the pattern _f_i_l_e%%
  56.      ff::_f_i_l_e__n_a_m_e   ff::ffiillee11  File name ffiillee11
  57.      _f_i_l_e__n_a_m_e     mmyyffiillee   File name mmyyffiillee
  58.      -------------------------------------------------------------
  59.  
  60.      An _a_s_s_i_g_n__o_b_j_e_c_t that is a pattern may contain wildcard characters %%
  61.      and __.  The %% character matches any sequence of 0 or more characters;
  62.      the __ character matches any single character.
  63.  
  64.      The run-time I/O library applies the options to a file connection
  65.      whenever _a_s_s_i_g_n__o_b_j_e_c_t is opened.  The application of options occurs
  66.      whenever a file is opened by any of the following:
  67.  
  68.      * Fortran I/O
  69.             Fortran OOPPEENN statement
  70.             Implicit Fortran open via some I/O statement
  71.  
  72.      * FFIO
  73.             ffffooppeenn(3C) library routine
  74.             ffddccpp(1) command
  75.  
  76.      * Fortran auxiliary I/O
  77.             WWOOPPEENN(3F) library routine
  78.             OOPPEENNMMSS(3F) library routine
  79.             OOPPEENNDDRR(3F) library routine
  80.             AAQQOOPPEENN(3F) library routine
  81.  
  82.      When any of these I/O routines opens a file, they use aassssiiggnn options
  83.      for any _a_s_s_i_g_n__o_b_j_e_c_t which applies to the open request.  As many as
  84.      five _a_s_s_i_g_n__o_b_j_e_c_t_s can apply to an open request:
  85.  
  86.      * gg::aallll applies to any open.
  87.  
  88.      * gg::ssuu, gg::ssff, gg::dduu, gg::ddff, gg::aaqq, and gg::ffff each apply to types of open
  89.        requests (for example, Fortran sequential unformatted, Fortran
  90.        sequential formatted, Fortran direct unformatted, Fortran direct
  91.        formatted, AQOPEN, and ffffooppeenn, respectively).
  92.  
  93.      * uu::NN applies whenever Fortran unit _N is opened.
  94.  
  95.      * pp::_p_a_t_t_e_r_n applies whenever a file with a name matching _p_a_t_t_e_r_n is
  96.        opened.  The aassssiiggnn environment can contain only one pp::_a_s_s_i_g_n__o_b_j_e_c_t
  97.        that matches the current open.  The exception is that the pp::%%
  98.        pattern is silently ignored if a more specific pattern also matches
  99.        the current filename being opened.
  100.  
  101.      * ff::_f_i_l_e_n_a_m_e applies whenever a file with the name _f_i_l_e_n_a_m_e is opened.
  102.  
  103.      Options from the _a_s_s_i_g_n__o_b_j_e_c_ts in the above categories are collected
  104.      to create the complete set of options used for any particular open
  105.      operation.  The options are collected in the above order, with options
  106.      collected later in the list of _a_s_s_i_g_n__o_b_j_e_c_t_s overriding those
  107.      collected earlier.
  108.  
  109.      On UNICOS and UNICOS/mk systems, assign information is stored in the
  110.      aassssiiggnn environment file, $$TTMMPPDDIIRR//..aassssiiggnn, by default.  The location of
  111.      the active aassssiiggnn environment can be changed by assigning a file name
  112.      or a process environment variable to the FFIILLEENNVV environment variable.
  113.  
  114.      On IRIX systems, you must set the FFIILLEENNVV environment variable to use
  115.      the aassssiiggnn command.  FFIILLEENNVV can contain the pathname of a file which
  116.      will be used to store aassssiiggnn information, or it can specify that the
  117.      information should be stored in the process environment. See the
  118.      examples in the EXAMPLE section.
  119.  
  120.      There are two main groups of aassssiiggnn command options:  control options
  121.      and I/O processing options.  This man page describes both types of
  122.      options.
  123.  
  124.    CCoonnttrrooll ooppttiioonnss
  125.      These options are available on IRIX systems and UNICOS and UNICOS/mk
  126.      systems:
  127.  
  128.      --II      Specifies an incremental assign.  All options are added on to
  129.              the options already assigned to the current _a_s_s_i_g_n__o_b_j_e_c_t.
  130.              This option and the --OO option are mutually exclusive.
  131.  
  132.      --OO      Specifies a replacement assign.  All currently existing aassssiiggnn
  133.              options for the current _a_s_s_i_g_n__o_b_j_e_c_t are replaced.  This
  134.              option is the default control option and is mutually exclusive
  135.              from the --II option.
  136.  
  137.      --RR      Removes all aassssiiggnn options for _a_s_s_i_g_n__o_b_j_e_c_t.  If
  138.              _a_s_s_i_g_n__o_b_j_e_c_t is not specified, all currently assigned options
  139.              for all _a_s_s_i_g_n__o_b_j_e_c_ts are removed.
  140.  
  141.      --VV      Views options for _a_s_s_i_g_n__o_b_j_e_c_t.  If _a_s_s_i_g_n__o_b_j_e_c_t is not
  142.              specified, all currently assigned options for all assign
  143.              objects are printed.
  144.  
  145.    II//OO pprroocceessssiinngg ooppttiioonnss
  146.      I/O processing options specify aspects of I/O processing.  Each option
  147.      applies to one or more supported I/O type:  Fortran I/O, FFIO, or
  148.      Fortran auxiliary I/O (AQIO, WAIO, DRIO, and MSIO).
  149.  
  150.      The special "default" option value is available for all aassssiiggnn
  151.      attribute options with the exception of the --aa option.  The "default"
  152.      option value has the same effect as if the corresponding option were
  153.      unspecified. It can be used to nullify an option value set in a more
  154.      general type of aassssiiggnn.  For example, the following commands show how
  155.      you can set a buffer size of 20 blocks for all files except the file
  156.      ssmmaallllffiillee:
  157.  
  158.           assign -b 20 g:all
  159.           assign -b default f:smallfile
  160.  
  161.    OOppttiioonnss aanndd AArrgguummeennttss
  162.      --aa _a_c_t_u_a_l_f_i_l_e
  163.                  Specifies the actual file name.  Used by Fortran I/O and
  164.                  auxiliary I/O.
  165.  
  166.                  Available on IRIX systems.
  167.  
  168.                  When the --aa option is assigned to a unit, open processing
  169.                  for the unit results in a connection to _a_c_t_u_a_l_f_i_l_e.  An
  170.                  error occurs if --aa has been specified for a unit that is
  171.                  opened with an explicit FFIILLEE== specifier in the OOPPEENN
  172.                  statement.
  173.  
  174.                  When --aa is assigned to a file name, the file name becomes
  175.                  an alias for _a_c_t_u_a_l_f_i_l_e.  When _f_i_l_e__n_a_m_e is specified as
  176.                  the FFIILLEE== specifier in an OOPPEENN statement, _a_c_t_u_a_l_f_i_l_e is
  177.                  opened instead of _f_i_l_e__n_a_m_e.  A similar effect occurs if
  178.                  the llnn(1) command is used to establish a symbolic link.
  179.  
  180.                  The --aa and --DD options cannot both be provided.
  181.  
  182.      --bb _b_s       Specifies buffer size of the library's I/O buffer in units
  183.                  of 4096-byte blocks.  Used by Fortran I/O and auxiliary
  184.                  I/O.
  185.  
  186.                  Available on IRIX systems.
  187.  
  188.                  On UNICOS and UNICOS/mk systems, the default buffer sizes
  189.                  in 4096-byte blocks are as follows.
  190.  
  191.                Sequential formatted     8
  192.                Sequential unformatted   48
  193.                Direct access formatted  Minimum (record length + 1 byte, 8
  194.                                         blocks)
  195.                Direct access            Maximum (record length, 8 blocks)
  196.                unformatted
  197.  
  198.                  Direct access unformatted files have 4 buffers.
  199.  
  200.                  On IRIX systems, the default buffer sizes in 4096-byte
  201.                  blocks are as follows:
  202.  
  203.                Sequential formatted     8
  204.                Sequential unformatted   8
  205.                Direct access formatted  16
  206.                Direct access            16
  207.                unformatted
  208.  
  209.                  Direct files have 4 buffers.
  210.  
  211.      --cc          Specifies contiguous storage.  Must be used in conjunction
  212.                  with the --nn option.  Used by Fortran I/O and auxiliary
  213.                  I/O.
  214.  
  215.                  Deferred implementation on IRIX systems.
  216.  
  217.                  Requests that contiguous disk space be allocated to the
  218.                  file.
  219.  
  220.      --dd _b_d_r      Specifies automatic recovery of bad data for online tape
  221.                  files.  Used by Fortran I/O and auxiliary I/O.
  222.  
  223.                  Deferred implementation on IRIX systems.
  224.  
  225.                  Valid values for _b_d_r are as follows:
  226.  
  227.                  _b_d_r            AAccttiioonn
  228.  
  229.                  sskkiippbbaadd        Skips bad data; no bad data is sent to your
  230.                                 buffer.
  231.  
  232.                  aaccppttbbaadd        Accepts bad data; makes bad data available.
  233.  
  234.                  When this option is used, explicit calls to the AACCPPTTBBAADD
  235.                  and SSKKIIPPBBAADD library routines are not necessary.  You will
  236.                  receive an error code indicating that a bad tape block has
  237.                  been encountered.
  238.  
  239.                  This option is valid only for online tape files.
  240.  
  241.                  For online tape files specified with aassssiiggnn --FF [[bbmmxx,,ttaappee]]
  242.                  or aassssiiggnn --ss [[bbmmxx,,ttaappee]], only one tape block is accepted
  243.                  or skipped at a time.  The --dd sskkiippbbaadd option is also valid
  244.                  for tape fields specified with the following command:
  245.  
  246.                   aassssiiggnn --FF [[iibbmm..uu,, iibbmm..vvbbss,, iibbmm..vvbb,, iibbmm..vv,,ttaappee]]
  247.  
  248.                  For these files, all consecutive bad tape blocks are
  249.                  skipped, and the user is placed at the beginning of the
  250.                  next record.  The --dd option is invalid with all other file
  251.                  specifications.
  252.  
  253.      --ff _f_o_r_t_s_t_d  This option specifies the type of Fortran with which to be
  254.                  compatible.  Used by Fortran I/O.
  255.  
  256.                  Valid values for _f_o_r_t_s_t_d are:
  257.  
  258.                  7777   Causes the Fortran file to be compatible with the
  259.                       FORTRAN 77 standard and Cray Research's CF77
  260.                       compiling system.
  261.  
  262.                  9900   Causes the Fortran file to be compatible with ANSI
  263.                       X3.198-1991 (Fortran 90) and Cray Research's CF90
  264.                       compiling system.
  265.  
  266.                  iirriixxff7777
  267.                       Causes the Fortran file to be compatible with Silicon
  268.                       Graphics' FORTRAN 77 compiling system which runs on
  269.                       IRIX systems.
  270.  
  271.                  iirriixxff9900
  272.                       Causes the Fortran file to be compatible with the
  273.                       MIPSpro 7 Fortran 90 compiling system.
  274.  
  275.                  A file's compatibility is established at open time.  By
  276.                  default, a Fortran file is compatible with the language
  277.                  from which an OOPPEENN statement or implicit open caused the
  278.                  file to be connected.  Implicit opens which result from
  279.                  calls to RREEAADDCC, RREEAADDCCPP, WWRRIITTEECC, or WWRRIITTEECCPP result in
  280.                  Fortran 90 compatibility mode by default.
  281.  
  282.      --ll _b_u_f_l_e_v   Controls kernel buffering; used by Fortran I/O, auxiliary
  283.                  I/O, and FFIO.
  284.  
  285.                  Deferred implementation on IRIX systems.
  286.  
  287.                  _b_u_f_l_e_v can be any of these values:
  288.  
  289.                  nnoonnee        Sets OO__RRAAWW and OO__LLDDRRAAWW
  290.  
  291.                  llddccaacchhee     Sets OO__RRAAWW, clear OO__LLDDRRAAWW
  292.  
  293.                  ffuullll        Clears OO__RRAAWW and OO__LLDDRRAAWW
  294.  
  295.                  If this option is not set, the level of system buffering
  296.                  is dependent on the type of open operation being
  297.                  performed.
  298.  
  299.      --mm _s_e_t_t_i_n_g  Activate or suppress special handling of a file which will
  300.                  be accessed concurrently by several processes or tasks.
  301.                  Used by Fortran I/O and auxiliary I/O.
  302.  
  303.                  Not available on IRIX systems.
  304.  
  305.                  Special handling includes skipping the check that only one
  306.                  Fortran unit be connected to a unit.  _s_e_t_t_i_n_g can be oonn or
  307.                  ooffff.
  308.  
  309.                  For files which are written, special handling also
  310.                  includes:
  311.  
  312.                  * Suppressing file truncation to true size by the I/O
  313.                    buffering routines.  Library buffer routines are usually
  314.                    flushed to disk in their entirety, and a truncation of
  315.                    the file at close time is done to trim the last file
  316.                    page to the correct size.
  317.  
  318.                  * Ensuring that the file will not be truncated after the
  319.                    last record written on sequential files (--mm oonn implies
  320.                    --TT ooffff).
  321.  
  322.                  If the file will be updated, the user is responsible for
  323.                  partitioning file access from all processes, tasks, or
  324.                  processing elements (PE) on library buffer page
  325.                  boundaries.  This can be done in the following ways:
  326.  
  327.                  * Specify the --bb aassssiiggnn option.
  328.  
  329.                  * Specify the first numeric parameter on the ccaacchhee or bbuuffaa
  330.                    FFIO layers (for example, --FF ccaacchhee::22 or --FF bbuuffaa::88).
  331.  
  332.                  * Specify no library buffering by using the --FF ssyysstteemm
  333.                    option.
  334.  
  335.                  For example, if several PEs concurrently open a file and
  336.                  specify --mm oonn, each PE might by convention update region
  337.                  MMYY__PPEE(()) of the file.  If the region size for each PE is 10
  338.                  blocks, the following aassssiiggnn options could be specified:
  339.  
  340.                     aassssiiggnn --mm oonn --FF ccaacchhee::55 uu::11
  341.  
  342.                  Specifying a buffer page size of 5 in this example assures
  343.                  alignment with PE file region boundaries because the
  344.                  region size (10) is an integral multiple of the buffer
  345.                  page size (5).
  346.  
  347.      --nn _s_z [:_s_t] Amount of system file space to reserve for a file.  This
  348.                  is a number of 4096-byte blocks.  Used by Fortran I/O,
  349.                  FFIO, and auxiliary I/O.
  350.  
  351.                  Deferred implementation on IRIX systems.
  352.  
  353.                  If this option is used with an existing file, _s_z 4096-byte
  354.                  blocks are added to the end of the file by use of
  355.                  iiaalllloocc(2).
  356.  
  357.                  NOTE:  Allocation of actual file space is not done until
  358.                  the file is opened in the Fortran libraries.  For
  359.                  immediate allocation, use the sseettff(1) command .
  360.  
  361.                  The optional _s_t value is an obsolete way to specify the --qq
  362.                  aassssiiggnn option.  Use of --qq is preferable to using the _s_t
  363.                  value on --nn.
  364.  
  365.      --pp _p_a_r_t_l_i_s_t File system partition list.  Used by Fortran I/O, FFIO,
  366.                  and auxiliary I/O.  _p_a_r_t_l_i_s_t indicates the partitions of a
  367.                  file system on which a file is to be allocated.
  368.  
  369.                  Deferred implementation on IRIX systems.
  370.  
  371.                  _p_a_r_t_l_i_s_t is used at file creation time by use of the _c_b_i_t_s
  372.                  argument on the ooppeenn(2) system call.  _p_a_r_t_l_i_s_t also
  373.                  controls the partitions where space is allocated using
  374.                  iiaalllloocc(2) when a --nn option is assigned.
  375.  
  376.                  _p_a_r_t_l_i_s_t can be a single number, a range (_m--_n), a set
  377.                  (_m::_n), or a combination of ranges and sets separated by
  378.                  colons.  The dash (--) in the range specifies a range of
  379.                  partitions to be used (for example, 2--5 means partitions 2
  380.                  through 5).  A colon (::) in the set specifies a list of
  381.                  partitions to be used (for example, 2:4:6 means partitions
  382.                  2, 4, and 6).  Partitions are numbered starting with 0.
  383.  
  384.                  You can use the ddff(1) command with the --pp option to
  385.                  display partitions on one or more file systems.
  386.  
  387.      --qq _o_c_b_l_k_s   Number of 4096-byte blocks to be allocated per file system
  388.                  partition.  Used by Fortran I/O, FFIO, and auxiliary I/O.
  389.                  _o_c_b_l_k_s is used at file creation time by use of the _c_b_l_k_s
  390.                  argument on the ooppeenn(2) system call.  _o_c_b_l_k_s also controls
  391.                  the number of blocks assigned per partition where space is
  392.                  allocated using iiaalllloocc(2) when a --nn option is assigned.
  393.  
  394.                  Deferred implementation on IRIX systems.
  395.  
  396.      --rr _s_e_t_t_i_n_g  Activates or suppresses the passing of the OO__RRAAWW flag to
  397.                  the ooppeenn(2) system call.  Used by Fortran I/O and FFIO.
  398.                  _s_e_t_t_i_n_g can be either oonn or ooffff.  This option is supported
  399.                  in programs linked with Cray Research's Programming
  400.                  Environment 3.0 and later releases.
  401.  
  402.                  Not available on IRIX systems.
  403.  
  404.      --ss _f_t       Specifies the file type.  Used by Fortran I/O.  See below
  405.                  for specific values supported on IRIX systems.
  406.  
  407.                  The file type defines the way records are delimited and
  408.                  how end-of-file is represented.  Some _f_t values also
  409.                  define the internal processing used for a file.
  410.  
  411.                  Enter one of the following for _f_t:
  412.  
  413.                  _f_t                FFiillee TTyyppee
  414.  
  415.                  bbiinn               Unblocked file structure with buffering.
  416.                                    Available on IRIX systems.
  417.  
  418.                  ccooss or bblloocckkeedd    COS blocked structure.  This is the
  419.                                    default structure for sequential
  420.                                    unformatted files on UNICOS and
  421.                                    UNICOS/mk systems.
  422.  
  423.                                    Available on IRIX systems.
  424.  
  425.                  ssbbiinn              Unblocked file structure with "stdio"
  426.                                    style buffering.  The Fortran I/O
  427.                                    library issues I/O which is compatible
  428.                                    with the C ffwwrriittee(3C) and ffrreeaadd(3C)
  429.                                    functions.  This file type is useful for
  430.                                    accessing pipe files.  It is not
  431.                                    permitted with formatted files.
  432.  
  433.                                    Available on IRIX systems.
  434.  
  435.                  ttaappee or bbmmxx       On UNICOS systems and UNICOS/mk systems,
  436.                                    this indicates the online tape access
  437.                                    method.  This file structure is required
  438.                                    for doing any type of Fortran I/O
  439.                                    (formatted, unformatted, or buffer I/O)
  440.                                    to an online tape file.
  441.  
  442.                                    Each read or write request results in
  443.                                    the processing of one tape block.  This
  444.                                    structure may be used only with online
  445.                                    IBM-compatible tape files or with ER90
  446.                                    volumes mounted in block mode on UNICOS
  447.                                    systems (see the _T_a_p_e _S_u_b_s_y_s_t_e_m _U_s_e_r'_s
  448.                                    _G_u_i_d_e, publication SG-2051, for more
  449.                                    information about restrictions on record
  450.                                    sizes when using ER90 block mode).
  451.  
  452.                                    Not available on IRIX systems.
  453.  
  454.                  tteexxtt              New-line characters delimit the records.
  455.                                    This is the default structure for
  456.                                    sequential formatted files.  On UNICOS
  457.                                    and UNICOS/mk systems, it is also the
  458.                                    default structure for direct-access
  459.                                    formatted files.
  460.  
  461.                                    Available on IRIX systems.
  462.  
  463.                  uu                 Each read or write request results in an
  464.                                    immediate system call.  Requests should
  465.                                    be made in multiples of 4096 bytes for
  466.                                    best performance.
  467.  
  468.                                    Available on IRIX systems.
  469.  
  470.                  uunnbblloocckkeedd         Adjacent records are not delimited from
  471.                                    one another.  This is the default
  472.                                    structure for direct-access unformatted
  473.                                    files.  On IRIX systems, it is also the
  474.                                    default structure for direct-access
  475.                                    formatted files.
  476.  
  477.                                    Available on IRIX systems.
  478.  
  479.                  Each file type has a set of valid access methods
  480.                  associated with it.  The following table lists the valid
  481.                  access methods for each of the file types.  In this table,
  482.                  "yes" indicates that the access method is allowed; "no"
  483.                  indicates that it is not allowed; "default"indicates that
  484.                  it is the default method on UNICOS, UNICOS/mk, and IRIX
  485.                  systems.
  486.  
  487.              --------------------------------------------------------------
  488.                            Sequential   Sequential   Direct       Direct
  489.                            formatted    unformatted  formatted    unformatted
  490.              --------------------------------------------------------------
  491.              bbiinn           No          Yes          Yes         Yes
  492.              ccooss||bblloocckkeedd   Yes         Yes **       No          No
  493.              ssbbiinn          Yes         Yes          Yes         Yes
  494.              tteexxtt          Default     No           Yes **      No
  495.              uu             No          Yes          Yes         Yes
  496.              uunnbblloocckkeedd     No          Yes          Yes ***     Default
  497.              ttaappee||bbmmxx*     Yes *       Yes *        No *        No *
  498.              --------------------------------------------------------------
  499.  
  500.                  *   Not available on IRIX systems
  501.  
  502.                  **  Default on UNICOS and UNICOS/mk systems
  503.  
  504.                  *** Default on IRIX systems
  505.  
  506.      --tt          Temporary file.  Used by Fortran I/O.
  507.  
  508.                  Available on IRIX systems.
  509.  
  510.                  This causes the file to be deleted when it is disconnected
  511.                  by using a CCLLOOSSEE statement or at program termination.
  512.                  Unlike SSTTAATTUUSS==''SSCCRRAATTCCHH'' on OOPPEENN, the --tt option does not
  513.                  affect the default file name selected for a unit.  If
  514.                  SSTTAATTUUSS==''KKEEEEPP'' is specified on the CCLLOOSSEE statement, it is
  515.                  silently ignored without error or warning.
  516.  
  517.      --uu _b_u_f_c_n_t   Buffer count.  Used by Fortran I/O.
  518.  
  519.                  Deferred implementation on IRIX systems.
  520.  
  521.                  Specifies the number of buffers to be allocated for a
  522.                  file.  This option can be used with direct-access
  523.                  unformatted files and with online tape files (UNICOS and
  524.                  UNICOS/mk systems).  The default is 4 for direct-access
  525.                  unformatted files and is system-dependent for online tape
  526.                  files.
  527.  
  528.      --ww _s_e_t_t_i_n_g  Activate or suppress the passing of the OO__WWEELLLLFFOORRMMEEDD flag
  529.                  to the ooppeenn(2) system call.  Used by Fortran I/O and FFIO.
  530.                  _s_e_t_t_i_n_g may be oonn or ooffff.
  531.  
  532.                  Deferred implementation on IRIX systems.
  533.  
  534.      --xx _s_e_t_t_i_n_g  Activate or suppress the passing of the OO__PPAARRAALLLLEELL flag to
  535.                  the ooppeenn(2) system call.  Used by Fortran I/O and FFIO.
  536.                  _s_e_t_t_i_n_g may be oonn or ooffff.  This option is supported in
  537.                  programs linked with Cray Research's Programming
  538.                  Environment 3.0 and later releases.
  539.  
  540.                  Not available on IRIX systems.
  541.  
  542.      --yy _s_e_t_t_i_n_g  Suppress repeat count in list-directed output.  _s_e_t_t_i_n_g
  543.                  can be oonn or ooffff.  The default setting is ooffff.
  544.  
  545.      --BB _s_e_t_t_i_n_g  Activate or suppress the passing of the OO__DDIIRREECCTT flag to
  546.                  the ooppeenn(2) system call.
  547.  
  548.                  Used by Fortran I/O and FFIO.  _s_e_t_t_i_n_g may be oonn or ooffff.
  549.  
  550.                  Available only on IRIX systems.  Not available on UNICOS
  551.                  or UNICOS/mk systems.
  552.  
  553.                  This option is supported by the ccaacchhee, ccaacchheeaa, and ssyysstteemm
  554.                  layers (see the --FF option).  Use of --BB with the ssyysstteemm
  555.                  layer requires that the user properly align their I/O
  556.                  requests.  The ccaacchhee and ccaacchheeaa layers will guarantee
  557.                  proper alighment when --BB is specified.  See the ooppeenn(2)
  558.                  man page for more information about OO__DDIIRREECCTT.
  559.  
  560.      --CC _c_h_a_r_c_o_n  Specifies character set conversion.  Used by Fortran I/O.
  561.  
  562.                  This requests that certain I/O processors (currently
  563.                  limited to the Fortran I/O libraries) convert character
  564.                  data from this assumed character set on input and convert
  565.                  it to this character set on output.  _c_h_a_r_c_o_n must be one
  566.                  of the following:
  567.  
  568.                  aasscciiii (no-op)
  569.                  eebbccddiicc *
  570.                  ccddcc *
  571.  
  572.                  * Not supported on UNICOS/mk or IRIX systems.
  573.  
  574.      --DD _f_i_l_d_e_s   Specifies connection to a standard file.  Used by Fortran
  575.                  I/O.
  576.  
  577.                  Available on IRIX systems.
  578.  
  579.                  The --DD and --aa options cannot be used together.  Enter one
  580.                  of the following for _f_i_l_d_e_s:
  581.  
  582.                  _f_i_l_d_e_s    FFiillee
  583.  
  584.                  ssttddiinn     Connect to file descriptor 0
  585.  
  586.                  ssttddoouutt    Connect to file descriptor 1
  587.  
  588.                  ssttddeerrrr    Connect to file descriptor 2
  589.  
  590.      --FF _s_p_e_c[,,_s_p_e_c...]
  591.                  FFIO specification.  This is a comma-separated list of
  592.                  layers through which data is to be passed.  Used by
  593.                  Fortran I/O, auxiliary I/O, and FFIO.
  594.  
  595.                  See the IINNTTRROO__FFFFIIOO(3F) man page for details about the FFIO
  596.                  specifications and for details on which layers are
  597.                  available on IRIX systems.
  598.  
  599.                  Each layer specification is of the following general form:
  600.  
  601.                       _c_l_a_s_s[.._t_y_p_e[.._s_u_b_t_y_p_e]][::[_n_u_m_1]::[[_n_u_m_2]::[_n_u_m_3]]
  602.  
  603.                  For each class, _c_l_a_s_s specifies the class of processing to
  604.                  be done.  Many _c_l_a_s_s values also accept _t_y_p_e and/or
  605.                  _s_u_b_t_y_p_e fields to modify their behavior; other _c_l_a_s_s
  606.                  values accept only the _c_l_a_s_s itself (for example,
  607.                  ssyyssccaallll).  Following the _t_y_p_e and _s_u_b_t_y_p_e fields, many
  608.                  classes accept numeric fields to further tune or modify
  609.                  the file processing.  Units in these numeric fields differ
  610.                  depending on _c_l_a_s_s.
  611.  
  612.                  All specification lists end, either implicitly or
  613.                  explicitly, with the ssyysstteemm layer.  If this layer is not
  614.                  specified, it is added automatically.
  615.  
  616.                  Acceptable values for _c_l_a_s_s are as follows:
  617.  
  618.                  _c_l_a_s_s             VVaalluuee
  619.  
  620.                  bbllaannkkxx or bbllxx     Blank compression filters.  Not
  621.                                    available on IRIX systems.
  622.  
  623.                  bbmmxx or ttaappee       Online tape handlers.  Deferred
  624.                                    implementation on IRIX systems.
  625.  
  626.                  bbuuffaa              Buffering layer.  Available on IRIX
  627.                                    systems.
  628.  
  629.                  cc220055              CDC CYBER 205/ETA record formats.  Not
  630.                                    available on IRIX systems.
  631.  
  632.                  ccaacchhee             Cache layer.  Available on IRIX systems.
  633.  
  634.                  ccaacchheeaa            Asynchronous ccaacchhee layer.  Available on
  635.                                    IRIX systems.
  636.  
  637.                  ccddcc               CDC 60-bit record format.  Not available
  638.                                    on IRIX systems.
  639.  
  640.                  ccooss or bblloocckkeedd    COS blocking; default for Fortran
  641.                                    sequential unformatted I/O on UNICOS and
  642.                                    UNICOS/mk systems.  Available on IRIX
  643.                                    systems.
  644.  
  645.                  eerr9900              ER90 handlers.  Not available on IRIX
  646.                                    systems or on CRAY T3E systems.
  647.  
  648.                  eevveenntt             Event layer, used to monitor I/O
  649.                                    activity between layers.  This layer
  650.                                    generates statistics in the form of an
  651.                                    ASCII log file.  Deferred implementation
  652.                                    on IRIX systems.
  653.  
  654.                  ff7777               FORTRAN 77/UNIX Fortran record blocking.
  655.                                    Available on IRIX systems.  This is the
  656.                                    default structure for sequential
  657.                                    unformatted files on IRIX systems.
  658.  
  659.                  ffdd                Open a specific file descriptor.
  660.                                    Available on IRIX systems.
  661.  
  662.                  gglloobbaall            UNICOS/mk file global to all PEs.  This
  663.                                    is a caching layer which distributes the
  664.                                    cache across all PEs.  See the
  665.                                    IINNTTRROO__FFFFIIOO(3F) man page for more
  666.                                    details.  Deferred implementation on
  667.                                    IRIX systems.
  668.  
  669.                  iibbmm               IBM record formats.  Deferred
  670.                                    implementation on IRIX systems.
  671.  
  672.                  mmrr                Memory-resident files.  Deferred
  673.                                    implementation on IRIX systems.
  674.  
  675.                  nnoossvvee             CDC NOS/VE record formats.  Not
  676.                                    available on IRIX systems.
  677.  
  678.                  nnuullll              Syntactic no-op.  Available on IRIX
  679.                                    systems.
  680.  
  681.                  ssddss               SDS-resident files.  Not supported on
  682.                                    CRAY T3E systems.  Not available on IRIX
  683.                                    systems.
  684.  
  685.                  ssiittee              Site-specific layer.  Available on IRIX
  686.                                    systems.
  687.  
  688.                  ssttddiinn, ssttddoouutt, or ssttddeerrrr
  689.                                    Open file descriptors 0, 1, or 2,
  690.                                    respectively (see ffdd layer).  Available
  691.                                    on IRIX systems.
  692.  
  693.                  ssyyssccaallll           System call I/O.  Available on IRIX
  694.                                    systems.
  695.  
  696.                  ssyysstteemm            Generic system layer.  Available on IRIX
  697.                                    systems.
  698.  
  699.                  tteexxtt              Special character-terminated record.
  700.                                    Available on IRIX systems.
  701.  
  702.                  uusseerr              User layer.  Available on IRIX systems.
  703.  
  704.                  vvmmss               VAX/VMS record format.  Deferred
  705.                                    implementation on IRIX systems.
  706.  
  707.                  For more information on the classes, see the
  708.                  IINNTTRROO__FFFFIIOO(3F) man page.
  709.  
  710.      --LL _s_e_t_t_i_n_g  Activate or suppress the passing of the OO__LLDDRRAAWW flag to
  711.                  the ooppeenn(2) system call.  Used by Fortran I/O and FFIO.
  712.                  _s_e_t_t_i_n_g may be oonn or ooffff.  This option is supported in
  713.                  programs linked with Cray Research's Programming
  714.                  Environment 3.0 and later releases.
  715.  
  716.                  Not available on IRIX systems.
  717.  
  718.      --NN _n_u_m_c_o_n   Specifies foreign numeric conversion.  Used by Fortran
  719.                  I/O.
  720.  
  721.                  Fortran unformatted I/O converts numeric data from this
  722.                  assumed numeric format on input, and converts it to this
  723.                  numeric format on output.
  724.  
  725.                  If this option is used and the --CC option is not used,
  726.                  appropriate character defaults are used.
  727.  
  728.                  Each value for _n_u_m_c_o_n selects a particular type of foreign
  729.                  data conversion.  Each option has a mapping that
  730.                  associates each of the native data types with a
  731.                  corresponding foreign data type and length in bits.
  732.                  Appropriate data conversion is done on unformatted input
  733.                  and output operations.
  734.  
  735.                  For example, entering --NN iibbmm selects the following
  736.                  mapping:
  737.  
  738.                  CCRRII DDaattaa TTyyppee            IIBBMM DDaattaa TTyyppee
  739.  
  740.                  64-bit IINNTTEEGGEERR           32-bit IINNTTEEGGEERR**44
  741.  
  742.                  64-bit RREEAALL              32-bit RREEAALL**44
  743.  
  744.                  128-bit DDOOUUBBLLEE           64-bit DDOOUUBBLLEE PPRREECCIISSIIOONN
  745.  
  746.                  128-bit CCOOMMPPLLEEXX          64-bit CCOOMMPPLLEEXX
  747.  
  748.                  64-bit LLOOGGIICCAALL           32-bit LLOOGGIICCAALL**44
  749.  
  750.                  8-bit AASSCCIIII CCHHAARRAACCTTEERR    8-bit EEBBCCDDIICC CCHHAARRAACCTTEERR
  751.  
  752.                  Short IINNTTEEGGEERR**22          16-bit IINNTTEEGGEERR**22
  753.  
  754.                  The following tables list the values for _n_u_m_c_o_n on
  755.                  different hardware platforms.
  756.  
  757.                  Cray PVP systems (non-IEEE)
  758.  
  759.                  ---------------------------------------------------
  760.                             --CC
  761.                  --NN option  default    Meaning
  762.                  ---------------------------------------------------
  763.                  none       none       No data conversion
  764.                  default    default    No data conversion
  765.                  ccrraayy       ASCII      No data conversion
  766.                  iibbmm        EBCDIC     IBM data conversion
  767.                  iibbmm__ddpp     EBCDIC     IBM data conversion;
  768.                                        floating-point is 64-bits
  769.                  CCDDCC        cdc        CDC 60-bit data conversion
  770.                  nnoossvvee      ASCII      CDC NOS/VE data conversion
  771.                  cc220055       ASCII      CDC CYBER 205 (ETA) data
  772.                                        conversion
  773.                  vvmmss        ASCII      VAX/VMS data conversion
  774.                  vvmmss__ddpp     ASCII      VAX/VMS data conversion;
  775.                                        floating-point is 64-bits
  776.                  iieeeeee       ASCII      Generic 32-bit IEEE data
  777.                                        conversion
  778.                  iieeeeee__3322               (alias for above)
  779.                  iieeeeee__ddpp    ASCII      IEEE data conversion;
  780.                                        floating-point is 64-bits
  781.                  mmiippss       ASCII      SGI MIPS IEEE data conversion
  782.                                        (128-bit floating-point is
  783.                                        "double double" format)
  784.                  iieeeeee__6644    ASCII      CRAY 64-bit IEEE data
  785.                                        conversion
  786.                  iieeeeee__llee    ASCII      Little endian 32-bit IEEE
  787.                                        data conversion
  788.                  uullttrriixx                (alias for above)
  789.                  iieeeeee__llee__ddpp ASCII      Little endian 32-bit IEEE
  790.                                        data conversion; floating-
  791.                                        point is 64-bits
  792.                  uullttrriixx__ddpp             (alias for above)
  793.                  tt33ee        ASCII      CRAY 64-bit IEEE data
  794.                                        conversion; denormalized
  795.                                        numbers flushed to zero
  796.                  tt33dd                   (alias for above)
  797.                  uusseerr       ASCII      User defined data conversion
  798.                  ssiittee       ASCII      Site defined data conversion
  799.                  ---------------------------------------------------
  800.  
  801.                  Cray MPP systems
  802.  
  803.                  ---------------------------------------------------
  804.                             --CC
  805.                  --NN option  default    Meaning
  806.                  ---------------------------------------------------
  807.                  none       none       No data conversion
  808.                  default    default    No data conversion
  809.                  ccrraayy       ASCII      No data conversion
  810.                  iieeeeee       ASCII      Generic 32-bit IEEE data
  811.                                        conversion
  812.                  iieeeeee__3322               (alias for above)
  813.                  tt33ee        ASCII      CRAY 64-bit IEEE data
  814.                                        conversion; denormalized
  815.                                        numbers flushed to zero
  816.                  tt33dd        ASCII      No data conversion
  817.                  uusseerr       ASCII      User defined data conversion
  818.                  ssiittee       ASCII      Site defined data conversion
  819.                  ---------------------------------------------------
  820.  
  821.                  CRAY T90/IEEE
  822.  
  823.                  ---------------------------------------------------
  824.                             --CC
  825.                  --NN option  default    Meaning
  826.                  ---------------------------------------------------
  827.                  none       none       No data conversion
  828.                  default    default    No data conversion
  829.                  ccrraayy       ASCII      No data conversion
  830.                  iibbmm        EBCDIC     IBM data conversion
  831.                  iibbmm__ddpp     EBCDIC     IBM data conversion;
  832.                                        floating-point is 64-bits
  833.                  iieeeeee       ASCII      Generic 32-bit IEEE data
  834.                                        conversion
  835.                  iieeeeee__3322               (alias for above)
  836.                  iieeeeee__ddpp    ASCII      IEEE data conversion;
  837.                                        floating-point is 64-bits
  838.                  iieeeeee__6644    ASCII      CRAY 64-bit IEEE data
  839.                                        conversion
  840.                  uusseerr       ASCII      User defined data conversion
  841.                  ssiittee       ASCII      Site defined data conversion
  842.                  ---------------------------------------------------
  843.  
  844.                  SGI IRIX (MIPS)
  845.  
  846.                  ---------------------------------------------------
  847.                             --CC
  848.                  --NN option  default    Meaning
  849.                  ---------------------------------------------------
  850.                  none       none       No data conversion
  851.                  default    default    No data conversion
  852.                  ccrraayy       ASCII      Cray PVP (non-IEEE) data
  853.                                        conversion
  854.                  mmiippss       ASCII      No data conversion
  855.                  uusseerr       ASCII      User defined data conversion
  856.                  ssiittee       ASCII      Site defined data conversion
  857.                  ---------------------------------------------------
  858.  
  859.      --PP _s_c_o_p_e    Specifies the scope of a Fortran unit.  Used by Fortran
  860.                  I/O and auxiliary I/O.  Deferred implementation on IRIX
  861.                  systems.
  862.  
  863.                  Allows specification of private I/O on UNICOS systems.
  864.                  Valid values for _s_c_o_p_e are:
  865.  
  866.                  pprriivvaattee   Causes a Fortran unit to be private to a task.
  867.                            Any unit number assigned this option is visible
  868.                            only to the task which opens it.  Other tasks
  869.                            may open the same unit number to the same or
  870.                            different files.
  871.  
  872.                  gglloobbaall    Supported on UNICOS systems only.  Causes a
  873.                            Fortran unit to be global to an application.  An
  874.                            application is defined as a process or
  875.                            multitasked group on UNICOS systems.
  876.  
  877.                  tthhrreeaadd    Supported on UNICOS systems only.  Causes a
  878.                            Fortran unit to be private to a multitasking
  879.                            thread.  Any unit number assigned this option is
  880.                            visible only to the thread which opens it.
  881.                            Other threads may open the same unit number to
  882.                            the same or different files.
  883.  
  884.                  The default for all Fortran units is --PP pprriivvaattee on
  885.                  UNICOS/mk systems and --PP gglloobbaall on UNICOS systems.  --PP
  886.                  pprriivvaattee may not be specified on UNICOS systems for a unit
  887.                  connected to ssttddiinn, ssttddoouutt, or ssttddeerrrr.
  888.  
  889.                  The following command selects private I/O for all Fortran
  890.                  units except scratch units, and ssttddiinn, ssttddoouutt, and ssttddeerrrr:
  891.  
  892.                       assign -P private p:%
  893.  
  894.      --SS _s_e_t_t_i_n_g  Suppress use of comma as a separator in list-directed
  895.                  output.  _s_e_t_t_i_n_g can be either oonn or ooffff.  The default
  896.                  setting is ooffff.
  897.  
  898.      --TT _s_e_t_t_i_n_g  Activates or suppresses truncation after write for
  899.                  sequential Fortran files.  Used by Fortran I/O.
  900.  
  901.                  Available on IRIX systems.
  902.  
  903.                  The selection of --TT oonn is standard and is the default
  904.                  setting for most file types.  Selecting --TT ooffff is useful
  905.                  in applications where GGEETTPPOOSS and SSEETTPPOOSS are used to
  906.                  simulate random access to a file with sequential I/O.
  907.  
  908.                  The following table describes the --TT option settings
  909.                  allowed for the file types specified with the --ss option.
  910.                  Unsupported combinations are diagnosed when a Fortran unit
  911.                  is opened.
  912.  
  913.                  -----------------------------------------
  914.                  File type         --TT oonn     --TT ooffff
  915.                  -----------------------------------------
  916.                  bbiinn               Allowed    Default
  917.                  ccooss or bblloocckkeedd    Default    Not allowed
  918.                  ssbbiinn              Default    Allowed
  919.                  ttaappee or bbmmxx       Default    Not allowed
  920.                  tteexxtt              Default    Allowed
  921.                  uu                 Allowed    Default
  922.                  uunnbblloocckkeedd         Default    Allowed
  923.                  -----------------------------------------
  924.  
  925.                  FFIO layers specified with the --FF option vary in their
  926.                  support for suppressing truncation with --TT ooffff.
  927.  
  928.      --UU _s_e_t_t_i_n_g  Produce a non-UNICOS form of list-directed output.
  929.                  _s_e_t_t_i_n_g can be either oonn or ooffff.  This setting is a global
  930.                  setting which sets the value for the --yy, --SS, and --WW
  931.                  options all to the same value.  The default setting is
  932.                  ooffff.
  933.  
  934.      --WW _s_e_t_t_i_n_g  Suppress compressed width in list-directed output.
  935.                  _s_e_t_t_i_n_g can be either oonn or ooffff.  The default setting is
  936.                  ooffff.
  937.  
  938.      --YY _s_e_t_t_i_n_g  Skip unmatched namelist group in the namelist input
  939.                  record.  _s_e_t_t_i_n_g can be either oonn or ooffff.  The default
  940.                  setting on UNICOS and UNICOS/mk systems is ooffff.  The
  941.                  default setting on IRIX systems is oonn.
  942.  
  943. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
  944.      The FFIILLEENNVV environment variable must be set to use the aassssiiggnn command
  945.      on IRIX systems.
  946.  
  947.      On UNICOS systems, FFIILLEENNVV does not have to be set.
  948.  
  949. EEXXAAMMPPLLEESS
  950.      Example 1:  The following example assigns an actual name
  951.      (//ttmmpp//ffoooo//ffiilleexxyyzz) and a buffer size of 8 sectors to unit 1, removing
  952.      any previously assigned options to unit 1:
  953.  
  954.           assign -a /tmp/foo/filexyz -b 8 u:1
  955.  
  956.      Example 2:  To assign unit 11 an unblocked file structure without
  957.      modifying any other options currently in effect for unit 11, use the
  958.      --II option as follows:
  959.  
  960.           assign -I -s unblocked u:11
  961.  
  962.      Example 3:  The following example sets up and uses the aassssiiggnn
  963.      environment file, aaffiillee, for a specific program.  The aassssiiggnn command
  964.      specifies that all files with the names matching the BBLLOOCCKKEEDD%% pattern
  965.      are COS blocked files:
  966.  
  967.           env FILENV=afile assign -F cos p:BLOCKED%
  968.           env FILENV=afile a.out
  969.  
  970.      Example 4:  Attributes may be stored in the pprroocceessss environment using
  971.      the aassssiiggnn or aassggccmmdd commands.  The following example uses the aassssiiggnn
  972.      command:
  973.  
  974.           setenv FILENV \$EVAR
  975.           eval `assign -F f77 foo`
  976.  
  977.      The following example uses the aassggccmmdd command:
  978.  
  979.           eval `asgcmd -F f77 foo`
  980.  
  981. SSEEEE AALLSSOO
  982.      aassggccmmdd(1), ddff(1), llnn(1), sseettff(1), ttppmmnntt(1), wwrriittee(1)
  983.  
  984.      iiaalllloocc(2), ooppeenn(2) in the
  985.  
  986.      aaccppttbbaadd(3F), aassssiiggnn(3F), ffffaassssiiggnn(3C), ffffooppeenn(3C), ffrreeaadd(3C),
  987.      iinnttrroo__ffffiioo(3F), ooppeennmmss(3F), ooppeennddrr (see ooppeennmmss(3F)), sskkiippbbaadd(3F)
  988.  
  989.      This man page is available only online.
  990.